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Intro 

• Darkest Dungeon 

• Turn-based RPG, Procedural 

• Windows/Mac/Linux/Ps4/Vita 

• 2-person programming team 

• C++ 11 custom engine and middleware 
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Syntax 

• A Class object 

• Contains data that never changes 

• Jester Hero Class 

• All Jesters have a max hp of 35 

• All Jesters can have a skill "inspiring_tune" 

• The Jester skill "battle_ballad" is ranged 
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Syntax 


•String Format 

The code to print "string_named_test 

•string. format( "string_named_%s", "test" ) 

•print( string ) 

will be shortened to 

•string_named_[name] 

•string_named_test 
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Generating Using IDs 

• When an ID is missing: 

• "FMOD: Could not find ID for event 

'[audio_event_id]'" 

• When an object with an ID is referencing 
missing ID: 

• "No effect of name [effect_id] so not 

adding to skill [skill id] " 
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Generating Using IDs 


• Using string formats, you can dynamically insert 
IDs into file paths 

• When new IDs are created the file paths are 
automatically generated 

• Identify missing files with error messages or 
temporary assets 
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Generating Using IDs 

• File paths in the same folder 

• resistance\resistanceJcon_[resistance_id].png 
a • resistance\resistance_icon_bleed.png 
4? • resistance\resistancejcon_move.png 


fcststdiices 

** Stun 

40% 

*Move 

40% 

A Blight 

60% 

Bleed 

30% 

* Disease 

20% 

** Debuff 

20% 

Death Blow 

67% 

©Trap 

10% 
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Generating Using IDs 


• File paths separated into different folders 
based on IDs: 



[item_type]\inv_[item_type] + [item_id].png 
trinket \inv_trinket+lucky_dice.png 
gem\inv_gem+ruby.png 
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Generating Using IDs 

• Multiple file paths with one ID 

• [hero_class]\[hero_class]. art. darkest and 
[hero_class]\[hero_class]. info, darkest 

• leper\leper. art. darkest and leper\leper.info. 

darkest 

• jester\jester. art. darkest and jester\j ester. info, 
darkest 
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Reference IDs Inside of Files 


• Share logic between Classes 

Buff Class Trinket Classes 


"id" : "book_of_relaxation ,, J 

"buffs" : 

[ 

"TRINKET_STRESSDMG_B1", 
"TRINKET_ACC_B1 " , 
"TRINKET_DEF_D2" 

h 

"heroclassrequirements" : 

[ 

i. 

"rarity" : "uncommon", 

"price" : 10000, 

"limit" : 0, 

"origindungeon" : 

y. 


”id” : "TRINKET_ACC_B1", 
"stat_type” : "combat_stat_add", 
"stat_sub_type" : "attack_rating", 

"amount" : 0.04, 
"renove_if_not_active" : false, 
”rule_type" : "always", 
"is_false_rule" : false, 
"rule_data" : { 

"float" : 0, 

"string" : "" 

} 

}, 


"id" : "lucky_dice", 

"buffs" : 

[ 

"TRINKET_ACC_B1", 

"TRINKET_DEF_B1" 

h 

"heroclassrequirements" : 
[ 

]. 

"rarity" : "common", 
"price" : 7500, 

"limit" : 0, 
"origindungeon" : 
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Reference IDs Inside of Files 


Reuse data from other definitions 


colour: 

. id 

colour: 

. id 

colour: 

. id 

colour: 

. id 

colour: 

. id 

colour: 

.id 

colour: 

. id 


. rgba 154 152 145 255 
. rgba 200 180 110 255 
.rgba 177 25 0 255 


.shared_id "notable" 

. shaned_id "neutral" 

. shared_id "neutral” 

. shared_id "hartnful"| 
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Reference IDs Inside of Files 

• Generate multiple types of classes 

• When parsing one Class you can generate 
another Class 

• Example: 

• All trinkets are items 

• For every trinket class we generate an item Class 

• Generated item Classes are of type of trinket and the 
same ID as the trinket class 
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Filesystem Hierarchy 

• Filesystem hierarchy can be used to 
create your IDs when parsing your file 
system 
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Filesystem Hierarchy 


• Example: Every folder in data/heroes is a 
hero class ID, and every folder in 
data/monsters is a monster Class ID 






monsters 




_ a 

MM 

J Home Share 

(?) t it ► This 

View 

PC ► Data (D:) * RedHook ► darkest 

data ► monsters 






v C/ Search monsters 

V O 

p 

fa ancestor_big 

fa ancestor_flawed 

fa ancestor_heart 

ancestor_nebula 

fa. ancestor_perfect 

5 . ancestor_pod 

fa, ancestor_small 

fa bloated_corpse 

gf, brigand.blood 


brigand_cannon 

fa. brigand_cutthroat 

fa. brigand_fuseman 

gfS brigand_fusilier 

fa. carrion_eater 

fa. carrion_eater_big 

fa. cauldron_empty 

fai cauldron_full 

fa cell.battle 


gf cell_white 

fa collector 

fa collector_battle 

fa^ collector_protect 

fa. collector_shaman 

fa corpse 

gf, corpsejarge 

fa crone 

gf, cultist_brawler 


fa cultist_harpy 

fa cultist_orgiastic 

fa cultist.shrouded 

cultistj/varlord 

fa. cultist_witch 

fa cyst 

gf drowned_anchor 

i gf, drowned_anchored 

gf, drowned.captain 


gf ectoplasm 

fa. ectoplasmjarge 

fa. errant_flesh_bat 

fa. errant_flesh_dog 

fa, fishman_crabby 

fa fishman_harpoon 

fa fishman_shaman 

fa, formless_guard 

fa formless_melee 


fa. formless_ranged 

fa formless_weak 

^ fungal_artillery 

fa. fungal.bloat 

gargoyle 

fa ghoul 

fa hag 

fa jellyfish 

fa madman 


fa maggot 

fa necromancer 

fa. octotank 

fa pewjarge 

fa. pew_medium 

fa pew_small 

fa prophet 

fa rabid_dog 

fa shambler 


fa. shambler_tentacle 

fa shuffler 

siren 

fa. skeleton_arbalist 

fa, skeleton_captain 

fa skeleton_common 

fa. skeleton_courtier 

fa skeleton_defender 

fa. skeleton_militia 


fa skeleton_spear 

fa snail_urchin 

0 . spider_spitter 

fa, spider_webber 

^ swine_drummer 

fa swine_piglet 

fa. swine_prince 

gf swine.reaver 

gf. swine_slasher 


fa. swine_wretch 
90 items 

fa swinetaur 

templar_melee 

fa templar_melee_mb 

templar_ranged 

fa templar_ranged_mb 

gf. totem_attack 

gf. totem_guard 

gf unclean.giant 

£= SI 
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Filesystem Hierarchy 

• We used regular expression-based file 
searches to get all files in a given folder 

• The folders: 

• data\monsters\bloated_corpse\ 

• data\monste rs\s w i n eta u r\ 

• data\monsters\unclean_giant\ 

• Became monster IDs: 

• bloated_corpse, swinetaur, unclean giant 
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Linking Code Data to File Data 

• Uses preprocessor macros and enums 

• Links the declaration of enums to IDs 

• Enums can be used in code 

• IDs can be used for parsing data files 
and generating paths 
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Linking Code Data to File Data 


• Unlinked 


• eNumber and k_NumberIds 
have to be kept the same size 

• eNumber and k_NumberIds can 
have spelling inconsistencies 

• Spelling errors are not caught at 
compile time 
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// enure declaration 

enum eNumber 
{ 

k_zero, 

k_one, 

k_two, 

}; 

// id declaration 

const char* k_NumberIds[] = 
{ 

"zero”, 

"one”, 

"two", 

}; 





Linking Code Data to File Data 


• Linked 

• When types are added to 
NUMBER_TYPES_DECLARE 

• new enum elements are created 

• new IDs are created 

• spelling is consistent between 
eNumber and k_NumberIds 

• Spelling errors are caught at 
compile time 


// macro declaration 
♦define NUMBER_TYPES_DECLARE\ 

NUMBER_TYPE_DECLARATION( zero )\ 
NUMBER_TYPE_DECLARATION( one )\ 
NUMBER_TYPE_DECLARATION( two )\ 

II enum declaration 

enum eNumber 
{ 

♦define NU'BER_TYPE_DECLARATION( name ) kj»name, 
NUMBER_TYPES_DECLARE 

♦undef NUMBER_TYPE_DECLARATION 

}; 

// id declaration 

♦define NU'1BER_TYPE_DECLARATI0H( name ) ♦name,| 

const char* k_NumberIds[] = 

{ 

NUf1BER_TYPES_DECLARE 

}; 

♦undef NUMBER TYPE DECLARATION 
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Linking Code Data to File Data 

• Multiple constants can be linked to an enum 


#define OPTION TYPE DECLARE\ 






OPTION_TYPE_DECLARATION( fullscreen. 

Category: :k graphics. 

true. 

Value 

:eType: :k_Boolean, 

Value: :DefinitionIds: :k_default_toggle. 

OPTION TYPE_DEC LA RATION ( monitor_number. 

Category: :k graphics. 

true. 

Value 

:eType: :k_CustomValueRange, 

Value: :DefinitionIds : :k_default_custom. 

OPTION TYPE DECLARATION ( resolution. 

Category: :k graphics. 

true. 

Value 

:eType::k MultipleValueRange, 

Value: :DefinitionIds : :k resolution. 

OPTION TYPE DECLARATION ( combat pivot camera. 

Category: :k graphics. 

true. 

Value 

:eType::k Boolean, 

Value: :DefinitionIds: :k default toggle. 

OPTION TYPE DECLARATION ( blur. 

Category: :k graphics. 

true. 

Value 

:eType::k Boolean, 

Value: :DefinitionIds: :k default toggle. 

OPTION TYPE DECLARATION ( subtitles. 

Category: :k audio. 

true. 

Value 

:eType::k Boolean, 

Value: :DefinitionIds: :k default toggle. 

OPTION TYPE DECLARATION mute. 

Category: :k audio. 

true. 

Value 

:eType::k Boolean, 

Value: :DefinitionIds: :k default toggle. 

OPTION TYPE DECLARATION master volume. 

Category: :k audio. 

true. 

Value 

:eType::k ValueRange, 

Value: :DefinitionIds: :k volume. 

OPTION_TYPE_DECLARATION( sfx_volume. 

Category: :k_audio. 

true. 

Value 

:eType: :k_ValueRange, 

Value: :DefinitionIds: :k_volurae. 

OPTION TYPE DECLARATION music volume. 

Category: :k audio. 

true. 

Value 

:eType::k ValueRange, 

Value: :DefinitionIds: :k volume. 

OPTION TYPE DECLARATION narration volume. 

Category: :k audio. 

true. 

Value 

:eType::k ValueRange, 

Value: :DefinitionIds :: k volume. 

OPTION TYPE DECLARATION video volume. 

Category: :k audio. 

true. 

Value 

:eType::k ValueRange, 

Value: :DefinitionIds : :k volume. 

OPTION TYPE DECLARATION tutorial. 

Category: :k gameplay. 

true. 

Value 

:eType::k Boolean, 

Value: :DefinitionIds: :k default toggle. 

OPTION_TYPE_DECLARATION( ddjnode. 

Category: :k gameplay. 

true. 

Value 

:eType: :k_Boolean, 

Value: :DefinitionIds : : k_default_parent_toggle. 

OPTION_TYPE_DECLARATION( corpses. 

Category: :k_gameplay. 

true. 

Value 

:eType: :k_Boolean, 

Value: :DefinitionIds : :k_default_toggle. 

OPTION TYPE DECLARATION ( stall_penalty. 

Category: :k gameplay. 

true. 

Value 

:eTyp(e::k Boolean, 

Value: :DefinitionIds : :k default toggle. 

OPTION_TYPE_DECLARATION( deaths_door_recovery_debuff s. 

Category: :k gameplay. 

true. 

Value 

:eType: :k_Boolean, 

Value: :DefinitionIds: :k_default_toggle. 

OPTION TYPE DECLARATION ( retreats_can fail. 

Category: :k gameplay. 

true. 

Value 

:eType: :k_Boolean, 

Value: :DefinitionIds : :k_default_toggle. 

OPTION TYPE DECLARATION multiplied enemy crits. 

Category: :k gameplay. 

true. 

Value 

:eType::k Boolean, 

Value: :DefinitionIds: :k default toggle. 

OPTION TYPE DECLARATION ( metrics. 

Category: :k other. 

true. 

Value 

:eType::k Boolean, 

Value: :DefinitionIds: :k default toggle. 

OPTION TYPE DECLARATION ( extra bark time. 

Category: :k other. 

true. 

Value 

:eType::k ValueRange, 

Value: :DefinitionIds: :k extra bark time. 

OPTION TYPE DECLARATION ( bark dismissal. 

Category: :k other. 

true. 

Value 

:eType::k Boolean, 

Value: :DefinitionIds: :k default toggle. 

OPTION TYPE DECLARATION debug output. 

Category: :k other. 

true. 

Value 

:eType::k Boolean, 

Value: :DefinitionIds: :k default toggle. 

OPTION_TYPE_DECLARATION( language. 

Category: :k_other. 

false. 

Value 

:eType: :k_CustomValueRange, 

Value: :DefinitionIds: :k_default_custom. 
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Linking Code Data to File Data 

• Constants can be accessed by enum input functions 


Types: :eType GetTypeFromTypeId( Typeld typeld ); 
const char* GetIdFromType( Types: :eType type ); 

Typeld GetTypeIdFromType( Types: :eType type ); 

Category: :eCategory GetCategoryFro<nType( Types: :eType type ); 

Value : :eType GetValueTypeFromType( Types: :eType type ); 

Value: :DefinitionIds: :eType GetValueDef initionIdTypeFromType( Types: :eType type ); 
Value : :eDisplayType GetValueDisplayTypeFromType( Types: :eType type ); 
bool GetDoesUpdateOnChangeFromType( Types: :eType type ); 
bool GetDoesUpdateRequireRestartFromType( Types: :eType type ); 

Typeld GetParentTypeIdFromType( Types: :eType type ); 

bool GetCanModifyInNewGamePlusFromType( Types ::eType type ); 

bool AreDefaultDifficultyOptionsSet( void ); 
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Automatically Generating Data 

• Save/Load is JSON based 

• Analytics data is JSON based 

• Parsing consists of going through an 
enum and using the linked IDs as keys 
JSON dictionaries 
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Automatically Generating Data 


"version": 1, 

"data": { 

"values": { 

"fullscreen": [ 0 ], 
"monitornumber" : [ 0 ], 
"resolution": [ 1280, 720 ], 
"combat_pivot_camera" : [ 1 ], | 
"blur": [ 1 ], 

"subtitles": [ 1 ], 

"mute": [ 1 ], 

"mastervolume" : [ 100 ], 
"sfx_volume" : [ 100 ], 
"musicvolume" : [ 0 ], 
"narration_volume" : [ 0 ], 
"videovolume" : [ 100 ], 
"metrics": [ 1 ], 
"extra_bark_time" : [ 0 ], 
"bark_dismissal" : [ 1 ], 

"debu g output": [ 1 ], 
"language": "english" 


for ( uint32 i = 0; i < Types : :k_count; i-H- ) 

{ 

auto optionType = ( Options :: Types : :eType )i; 

auto optionCategory = Options : :GetCategoryFromType( optionType ); 

auto saveLocation = Options : :GetSaveLocationFromCategory( optionCategory ); 

if ( saveLocation == SaveLocation_Global ) 

t 

auto& element = m_CurrentData.m_Elements[i] j 

const auto& typeData = k_TypeData[i]; 

if ( typeData.m_UseValueData ) 

{ 

element . m_ValueData . clear ( ) ; 

pRestoreData->get( k_TypeData[i] .m_Id . e, element .m_ValueData ); 

if ( element. m_ValueData. empty () ) 

{ 

// set to default data to make sure if we add options they are added 

m_CurrentData.m_Elements[i] = s_DefaultData.m_Elements[i]; 

} 

> 

else 

{ 


} 


} 


} 


pRestoreData->get( k_TypeData[i] .m_Id.e, element .m_StringData ); 
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Automatically Generating Data 


■profileoptions" : 

[ 

"tutorial" rtrue, ”deaths_door_recovery_debuffs" :true., "corpses" itrue., ”stall_penalty" :true., 
"multiplied_eneniy_crits" :true, " retreats_can_f ail” : true, "dd mode" : true 


for ( uint32 i = 0; i < Options: : Types : :k_count; i++ ) 

{ 

auto optionType = (Options: :Types: :eType)i; 

auto optionCategory = Options: :GetCategoryFromType( optionType ) j 

auto valueType = Options: :6etValueTypeFromType( optionType ); 

auto saveLocation = Options: :GetSaveLocationFromCategory( optionCategory ); 

if ( valueType == Options: : Value : :eType: :k_Boolean && saveLocation == Options :: SaveLocation :: SaveLocation_Prof ile ) 

{ 

bool isCurrentOptionTypeTrue = optionsSyste x .GetIsCurrentValueDataTrue( optionType ); 

profileOptionsValue.AddMember( Options: :GetIdFromType( optionType ), isCurrentOptionTypeTrue, jsonDataDocument.GetAllocator() ); 

} 
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Outro 

• Thanks to 

• Red Hook Studios 

• Power Up Audio 

• Pierre Tardif and Kelvin McDowell 

• Contact 

• @KeirMiron 

• business@keirmiron.com 
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